home *** CD-ROM | disk | FTP | other *** search
/ CDUTIL 13 / CDUTIL #13 Julio 1995.iso / windows / disk / readme.ase < prev    next >
Encoding:
Text File  |  1995-01-24  |  13.6 KB  |  354 lines
  1.      =========================================================
  2.         readme.ase - AutoCAD Release 13 for AutoCAD 386
  3.      =========================================================
  4.   
  5.        
  6.               November 25, 1994
  7.   
  8.   
  9.     CONTENTS 
  10.   
  11.     Important Information
  12.   
  13.     Driver-Specific Information
  14.  
  15.     AutoCAD Link API
  16.     
  17.     AutoCAD SQL Interface (ASI)
  18.  
  19.     Manual Corrections and Additions
  20.  
  21.     AutoCAD Developer's Guide, On-line Document
  22.  
  23.  
  24.     IMPORTANT INFORMATION
  25.     =====================
  26.   
  27.     - Installing the AutoCAD SQL Environment (ASE)
  28.   
  29.       Please refer to the last section of this file for up to date
  30.       information on ASE installation, configuration and drivers.  This
  31.       section contains chapter 7 of the AutoCAD Installation Guide in
  32.       its entirety and it should be used instead of the corresponding
  33.       chapter in the printed Installation Guide.  
  34.  
  35.     - Running the AutoCAD SQL Environment
  36.  
  37.       Under DOS, the DOS Share program (share.exe) must be run before
  38.       starting AutoCAD in order to use ASE.
  39.  
  40.     - Configuring the AutoCAD SQL Environment
  41.  
  42.       There are many components which comprise ASE.  These components need
  43.       to be available for ASE to run.  The asi.ini file is installed so that
  44.       the character set and collation definition files that ASE requires (as
  45.       well as some sample dBASE III PLUS tables) will be found automatically
  46.       when AutoCAD is started from the directory from which it is installed.
  47.  
  48.       If you want to start AutoCAD from a different directory you will need
  49.       to make the following modifications to the asi.ini file.  Edit the
  50.       asi.ini file in a text editor.
  51.  
  52.       Find the Path entry in the [ASI] section.  Modify the ase\lang to an
  53.       absolute path.  For example, if AutoCAD is installed to c:\acad, the
  54.       entry would be Path = c:\acad\ase\lang.  This will allow ASE and the
  55.       drivers to be able to find the character set and collation definition
  56.       files.
  57.  
  58.       Find the [DB3] section.  In that section the entry ASE = sample\dbf
  59.       must be changed to an absolute path. For example, if AutoCAD is
  60.       installed in c:\acad then change the entry to ASE = c:\acad\sample\dbf.
  61.  
  62.       If you receive errors from ASE indicating that it cannot find a file,
  63.       you need to check the path entries.
  64.     
  65.     - Editing the asi.ini File
  66.  
  67.       When editing the asi.ini file, make sure your editor saves the
  68.       file as plain ASCII text.  An editor such as DOS-Edit or
  69.       MS-Notepad is fine.  Some errors have arisen by using the Kedit
  70.       editor.
  71.  
  72.       If you edit the asi.ini file and ASE displays the error "asi.ini
  73.       is corrupt", you must use a different editor.
  74.  
  75.     - Using Drawings with ASE Links
  76.  
  77.       The ASE application (the ase.arx file) MUST first be loaded
  78.       BEFORE you use the Open, Insert, Xref or Dxfin command with any
  79.       files containing ASE link information if you want that data to be
  80.       recognized.  This rule also applies to the Dxfout command if you
  81.       want links preserved in the DXF file.
  82.  
  83.       To load the ASE application you may:
  84.      . choose any ASE command which will automatically load the
  85.        application.
  86.      . enter (arxload "ase") at the command line or use the Arx
  87.        command.
  88.      . place an entry for ase.arx in the acad.rx file, which will
  89.        automatically load the ASE application when AutoCAD starts
  90.        (see the documentation on the acad.rx file for further
  91.        details on its use).
  92.  
  93.     - Unloading the AutoCAD SQL Environment
  94.  
  95.       Once a Link Path Name (LPN) has been created, inserted or
  96.       attached to a drawing, the ase.arx file should NOT be unloaded
  97.       while editing that drawing.  ASE may be unloaded after entering a
  98.       new, empty drawing.  ASE may be unloaded at any time if no ASE
  99.       information (LPNs or links) exist in the drawing.  ASE will also
  100.       unload automatically after exiting AutoCAD.
  101.  
  102.       The Aseunload command is not in this release of AutoCAD.  To
  103.       unload the ASE application, type (arxunload "ase") at the command
  104.       prompt or use the Arx command to unload the ase.arx file.
  105.  
  106.     - The Undo Command
  107.  
  108.       At the time of this release, the AutoCAD Undo command does not
  109.       always send internal notification to applications.  Therefore,
  110.       ASE can't fully support the Undo command in all circumstances.
  111.       These are the known circumstances:
  112.  
  113.       . If you Undo after reloading a Displayable Attribute, you must
  114.         use the Regen command to update the screen.
  115.  
  116.       . If you Undo after either synchronizing or erasing
  117.         Displayable Attributes nested in blocks, you should use the
  118.         Zoom/All command (after the Regen command) to update the
  119.         screen.
  120.  
  121.       . The command sequence of Xbind/Block, Undo is not supported
  122.         in this release of ASE and should be avoided.
  123.  
  124.     - Drawings with Locked Layers
  125.  
  126.       ASE does not allow links to be edited for objects on locked
  127.       layers.  In these cases, ASE displays a Warning dialog box with a
  128.       message that the selected object is on a locked layer.  The
  129.       corresponding layer name and object handle are displayed in the
  130.       Diagnostic Parameters list box.  The user must unlock the layers
  131.       before editing the links.
  132.  
  133.       If an LPN has a link to an object on a locked layer, ASE dialog
  134.       buttons which manipulate links will be disabled when that LPN is
  135.       being used.
  136.  
  137.       When converting AutoCAD Release 12 drawings with links to Release
  138.       13 format (with the Open command), a warning will be displayed if
  139.       objects with links are on locked layers.  These links will be
  140.       erased.  The layer should first be unlocked in the Release 12
  141.       drawing before the conversion if those links are to be
  142.       maintained.
  143.  
  144.     - Partial DXFIN Support
  145.  
  146.       Partial DXFIN of objects with links is supported if ASE is first
  147.       loaded (BEFORE the Dxfin command) and "identical" LPN's already
  148.       exist in the drawing.  If the LPN's of the imported objects are
  149.       "duplicate" LPN's or if they do not already exist, then the
  150.       incoming links are considered invalid and will be discarded.
  151.  
  152.     - Selecting Drawing Objects with ASE
  153.  
  154.       Objects may be highlighted and placed into a selection set with
  155.       the Aserows and Aseselect commands.  Objects in model space and
  156.       paper space are highlighted and selected depending on the current
  157.       value of the Tilemode variable in conjunction with the CVPORT
  158.       variable.  When Tilemode=0 and Cvport=1, only object in paper
  159.       space are selected.  At all other times, objects in model space
  160.       are selected.
  161.  
  162.       In the ASEROWS and ASEEXPORT command, it is possible to specify
  163.       selection sets which contain objects from both model and paper
  164.       space.
  165.  
  166.     - Dialogue Boxes
  167.  
  168.       Edit fields have a maximum length of 254 characters in dialog boxes. 
  169.       SQL statements entered in dialog boxes cannot exceed this limit. 
  170.  
  171.  
  172.     - R12 Link Synchronization
  173.  
  174.       After R12 link synchronization has been completed via the
  175.       Aseadmin command, the user MUST NOT perform the command sequence
  176.       of Undo then Redo.  Undo by itself is possible if the user follows
  177.       the Undo with the Zoom/All command.
  178.  
  179.       During the synchronization of an R12 drawing which is attached as
  180.       an external reference to an R13 drawing, certain Link Path Names
  181.       (LPNs), will be stored in the permanent part of the drawing.
  182.       This occurs when an IDENTICAL link path name is detected in the
  183.       external reference.  If the xref is reloaded and the content of
  184.       the IDENTICAL LPN has changed, then the links associated with
  185.       this LPN cannot be resolved.  The external reference should be
  186.       detached, then reattach to prevent this from happening.
  187.  
  188.  
  189.       DRIVER-SPECIFIC INFORMATION
  190.       ===========================
  191.  
  192.     - Oracle and Informix ASI Drivers
  193.  
  194.       The Oracle and Informix ASI drivers were not available at the time
  195.       of this AutoCAD release.  If you wish to convert Release 12 drawings
  196.       that contain links to Oracle or Informix tables to Release 13 format,
  197.       you may still do so without these drivers being available.  Refer to
  198.       the information in Chapter 7 of the AutoCAD Installation Guide
  199.       (included at the end of this file) about converting Release 12 ASE
  200.       links to Release 13 ASE links.
  201.  
  202.  
  203.       AUTOCAD LINK API
  204.       ================
  205.  
  206.     - Supported Compilers
  207.  
  208.       This section contains documentation for supported compilers and other
  209.       development tools for ADS and ARX applications accessing AutoCAD links
  210.       with the AutoCAD Link API for the Windows, NT and DOS386 platform.
  211.  
  212.       For more information on how to create ADS or ARX applications see the
  213.       ADS Readme file.
  214.  
  215.       The following files are provided for developing ASE applications:
  216.  
  217.       ase.h      - AutoCAD Link API main header file.
  218.       aseclass.h - Class header file if using C++
  219.       aseconst.h - Constant definitions
  220.       asesmp.c   - Sample AutoCAD Link program.
  221.  
  222.       Windows and NT Support
  223.       MSVC++ 1.1 is supported for both ADS and ARX applications.
  224.       To create an ADS/ASE application use aseatm80.lib.
  225.       To create an ARX/ASE application use asertm80.lib.
  226.       See the make include file asitm80.mak for compiling.
  227.  
  228.       DOS386 Support
  229.       MSVC++1.1 is supported for both ADS and ARX applications.
  230.       To create an ADS/ASE application use aseapm80.lib.
  231.       To create an ARX/ASE application use aserpm80.lib.
  232.       See the make include file asipm80.mak for compiling.
  233.  
  234.       MetaWare High C/C++(TM) is supported for ADS only.
  235.       To create an ADS/ASE application use aseaph30.lib.
  236.       See the sample profile, asiph30.pro.
  237.  
  238.     - ASE AutoLISP API
  239.  
  240.       For the ase_linkcreate function, when specifying Displayable
  241.       Attribute entity parameters (group 8), they should be enclosed
  242.       into a double list.  For example:
  243.  
  244.        (ase_linkcreate ... 8 (list '((10 1. 1. 0.) (40 . 1.) (50 . 0.))) ...)
  245.  
  246.     - Connection to Environments
  247.  
  248.       Most API functions don't require an SQL-Environment to be connected
  249.       with the following exceptions:
  250.  
  251.       ase_lp_getPaths()
  252.       ase_lp_getStatus()
  253.       ase_ls_initLpCond()
  254.       ase_ls_initLpDscCond()
  255.  
  256.     - Subentity Selection
  257.  
  258.       Using the API, links may be created to subentities such as a vertex,
  259.       attribute or polyfacerecord.  If the linked subentity is selected,
  260.       the corresponding owner object (polyline, insert or polyface) will
  261.       be highlighted and/or added to the selection set.
  262.  
  263.     
  264.     AUTOCAD SQL INTERFACE
  265.     =====================
  266.  
  267.     - Supported Compilers
  268.  
  269.       This section contains documentation for supported compilers and
  270.       other development tools for ADS and ARX applications accessing
  271.       external databases with ASI for the Windows, NT and DOS386
  272.       platform.
  273.  
  274.       For information on how to create ADS or ARX applications see the
  275.       ADS Readme file.
  276.  
  277.       The following files are provided for developing ASI applications:
  278.  
  279.       asiappl.h  - Main application include file.
  280.       asi.h      - C interface 
  281.       asiclass.h - C++ Class interface
  282.       asiconst.h - Constant Definitions
  283.       asiucode.h - Unicode Definitions used in ASI
  284.       asiconf.h  - ASI.INI Configuration file access
  285.       asismp.c   - ASI sample ADS application.
  286.  
  287.       Windows and NT Support
  288.       MSVC++ 1.1 is supported for both ADS and ARX applications.
  289.       To create an ADS/ASI or ARX/ASI application use asiatm80.lib.
  290.       See the make include file asitm80.mak for compiling.
  291.  
  292.       DOS386 Support
  293.       MSVC++1.1 is supported for both ADS and ARX applications.
  294.       To create an ADS/ASI or ARX/ASI application use asiapm80.lib.
  295.       See the make include file asipm80.mak for compiling.
  296.  
  297.       MetaWare High C/C++(TM) is supported for ADS only.
  298.       To create an ADS/ASI application use asiaph30.lib.
  299.       See the sample profile, asiph30.pro.
  300.  
  301.     - ASILISP
  302.  
  303.       The Customization Guide refers to an application called ASILISP.
  304.       This application makes all of the ASI functions available through
  305.       AutoLISP.  ASILISP was not available at the time of this release,
  306.       but will become available in the future.
  307.       
  308.   
  309.     MANUAL CORRECTIONS AND ADDITIONS
  310.     ================================
  311.  
  312.     AutoCAD Developer's Guide, On-line Document
  313.     -------------------------------------------
  314.  
  315.     Chapter 9, "AutoCAD Link API":
  316.  
  317.     ase_appl_term() - The first sentence of the function description
  318.     should read, "Terminates the established interface with the ASE
  319.     module".
  320.  
  321.  
  322.     ase_dsc_free() - The first line should read:
  323.  
  324.     void ase_dsc_free(ASE_DSC *pDsc);
  325.  
  326.  
  327.     ase_dsc_isInit - The first line should read:
  328.  
  329.     EAsiBoolean  ase_dsc_isInit(ASE_DSC dsc);
  330.  
  331.  
  332.     Samples for the following functions may be found in the asesmp.c file:
  333.     ase_link_getDACols, ase_link_getNameSize, ase_lp_cmpDscName,
  334.     ase_lp_cmpName, ase_ls_initLp, ase_ls_initLpDsc.
  335.  
  336.  
  337.     ase_lp_getPathCode() - The table of return codes and database objects
  338.     should be replaced with this table:
  339.  
  340.     Return Code               Database Object Path
  341.     ---------------------------------------------------------
  342.     kAseUnknownNameCode       empty database object reference
  343.     kAseEnvCode               environment reference
  344.     kAseCatCode               catalog reference
  345.     kAseSchemaCode            schema reference
  346.     kAseTableCode             table reference
  347.     kAseLpnCode               table reference with the LPN
  348.  
  349.  
  350.     Chapter 11, "SQL2 Overview":
  351.  
  352.     The section titled, "Unsupported SQLSTATE Parameters" should read
  353.     "Unsupported SQL Features".
  354.